home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 January / macformat-020.iso / Shareware City / Education / RLaB / help / plot < prev    next >
Encoding:
Text File  |  1994-06-17  |  2.8 KB  |  91 lines  |  [TEXT/ttxt]
  1. plot:
  2.  
  3. Synopsis: RLaB graphics interface
  4.  
  5. Syntax: plot ( A )
  6.  
  7. Description:
  8.  
  9.     Plot A in the current sub-plot in the current plot-window.  A
  10.     can be a matrix, in which case the columns are plotted against
  11.     the 1st column. If A is a column vector, then the column is
  12.     plotted versus the row values. A can also be a list, in which
  13.     case each matrix in the list is plotted (this is a good way to
  14.     plot data with different scales).
  15.  
  16.     Plot and its related functions define a user interface to the
  17.     PLPLOT grpahics library. The PLPLOT graphics library can
  18.     produce output on X-windows, DOS, OS/2, Amiga, Tektronix,
  19.     PostScipt, and other output devices.
  20.  
  21.     The plot interface operation is based upon two important
  22.     concepts: the current plot-window, and the current sub-plot.
  23.  
  24.     The current plot-window is a valid concept only if selected
  25.     output device supports multiple windows (X-windows for
  26.     example).
  27.  
  28.     The current sub-plot should be available for all devices,
  29.     since sub-plots are individual plots that co-exist on the same
  30.     page, or display.
  31.  
  32.     Invoking pstart() will create a plot-window. The newly created
  33.     plot-window will be the current plot-window. If more than one
  34.     plot-window has been created, then the current window can be
  35.     selected with the pwin() function. The current plot-window can
  36.     be closed with pclose(). All of the plot-windows can be closed
  37.     with pend().
  38.  
  39.     Each plot-window can be divided up into more than 1 sub-plot
  40.     (the default). The number and arrangement of the sub-plots is
  41.     specified by the user when pstart() is invoked. All plot
  42.     manipulation functions, such as plstyle(), plgrid(), xlabel(),
  43.     etc... work on the current sub-plot. When plot() is used the
  44.     current sub-plot is created, after which the current sub-plot
  45.     is incremented. The sub-plots are incremented to the right,
  46.     and down (the same way you read an English language book).
  47.  
  48.     The following is a list of the plot related functions.
  49.  
  50.     pstart ( NCOL, NROW, DEVICE )
  51.     pwin ( NWIN )
  52.     showpwin ( )
  53.     pclose ( )
  54.     pend ( )
  55.  
  56.     plot ( DATA )
  57.     plhist ( DATA )
  58.     plhistx ( DATA )
  59.     plerry ( X, Y, Ymin, Ymax )
  60.     xlabel ( XLABEL )
  61.     ylabel ( YLABEL )
  62.     ptitle ( PTITLE )
  63.     plimits ( XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX )
  64.     plgrid ( GRID_STY_X, GRID_STY_Y )
  65.     plgrid3 ( GRID_STY_X, GRID_STY_Y, GRID_STY_Z )
  66.     plaxis ( X_STR, Y_STR )
  67.     plstyle ( PSTYLE )
  68.  
  69.     plot3 ( L3D )
  70.     plmesh ( L3D )
  71.     plcont ( CL )
  72.     zlabel ( ZLABEL )
  73.     plalt ( ALT )
  74.     plaz ( AZ )
  75.  
  76.     plfont ( FONT )
  77.     plwid ( WIDTH )
  78.     plptex ( TEXT, X, Y, DX, DY, JUST )
  79.     plegend ( DESCRIPTION )
  80.  
  81.     plprint ( FILENM, DEVICE )
  82.     replot ( )
  83.  
  84.     _plscol0 ( COLOR, RED, GREEN, BLUE )
  85.     
  86.     The high-level plot functions are implemented in RLaB. The
  87.     low-level plot functions mimic the Plplot application
  88.     programming interface (API). This particular method of
  89.     implementation was choosen to allow users maximum flexibility
  90.     when adding new or improved plot features.
  91.